SGGetChannelPlayFlags(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Configuration Functions for All Channel Components

SGGetChannelPlayFlags
The SGGetChannelPlayFlags function allows the sequence grabber component to retrieve the playback control flags that it set with the SGSetChannelPlayFlags function, which is described in the previous section.
pascal ComponentResult SGGetChannelPlayFlags (SGChannel c, 
                                              long *playFlags);
c
Identifies the channel connection for this operation.
playFlags
Contains a pointer to a long integer that is to receive flags and values that influence channel playback. The following values are defined:
channelPlayNormal

Your channel component uses its default playback methodology.
channelPlayFast

Your channel component sacrifices playback quality in order to achieve the specified playback rate.
channelPlayHighQuality

Your channel component plays the channel's data at the highest possible quality--this option sacrifices playback rate for the sake of image quality. This option may reduce the amount of processor time available to other programs in the computer. This option should not affect the quality of the recorded data, however.

The following flag is defined--this flag may be used with any of the values defined for this parameter (unused flags are set to 0):
channelPlayAllData
Your channel component tries to play all of the data it captures, even the data that is stored in offscreen buffers. This option is useful when you want to be sure that the user sees as much of the captured data as possible. The sequence grabber component sets this flag to 1 to play all the captured data. The sequence grabber component may combine this flag with any of the values defined for the playFlags parameter.